Namespace UserAction
UserAction
Defined in: UserAction.js.
| Constructor Attributes | Constructor Name and Description |
|---|---|
|
测试用例库文件,提供如event mock、iframe封装等各种常用功能 部分方法来源于YUI测试框架
|
| Method Attributes | Method Name and Description |
|---|---|
| <static> |
UserAction.checkAllChildAttribs(nodeA, nodeB)
检查两个节点(包含所有子节点)是否具有相同的属性
|
| <static> |
UserAction.checkHTMLSameStyle(html, doc, ele, descript)
查看传入的html是否与传入的元素ele具有相同的style,比较结束会执行QUnit的断言
|
| <static> |
UserAction.click(单击的元素对象, 单击事件的可选参数)
模拟鼠标单击事件
|
| <static> |
UserAction.cssStyleToDomStyle(cssName)
统一cssFloat和styleFloat
|
| <static> |
UserAction.dblclick(双击的元素对象, 双击事件的可选参数)
模拟鼠标双击事件
|
| <static> |
UserAction.delayhelper(oncheck, onsuccess,oncheck返回true时执行, onfail, timeout)
在一段时间内不断查询oncheck是否返回true,如果是则执行onsuccess,否则超时结束后执行onfail
|
| <static> |
UserAction.findPosition(oElement)
找到给定元素的左上角和右下角顶点的横坐标和纵坐标
|
| <static> |
UserAction.fireKeyEvent(type, 目标元素, options)
触发键盘事件,需要设置keyCode或charCode
|
| <static> |
UserAction.fireMouseEvent(target, type, options)
在某一个元素上模拟鼠标事件
|
| <static> |
UserAction.frameExt()
提供iframe扩展支持,用例测试需要独立场景的用例,由于异步支持,通过finish方法触发start
|
| <static> |
UserAction.functionListHelper()
提供队列方式执行用例的方案,接口包括start、add、next,方法全部执行完毕时会启动用例继续执行
|
| <static> |
UserAction.getChildHTML(co)
获取某一个元素的innerHTML,去掉了不可见字符
|
| <static> |
UserAction.getFloatStyle(ele)
获取元素的float属性,ie下用styleFloat获取,非ie用cssFloat
|
| <static> |
UserAction.getHTML(co)
获取某一个元素的outerHTML
|
| <static> |
UserAction.getIndex(node)
获取某一个节点在父节点所有孩子中的顺序
|
| <static> |
UserAction.getSelectedText()
得到选中区域的文本
|
| <static> |
UserAction.hasSameAttrs(nodeA, nodeB)
判断两个元素的所有属性是否都相同
|
| <static> |
UserAction.haveSameAllChildAttribs(nodeA, nodeB)
判断两个节点(包括所有子孙节点)所有的属性及style是否都相同
|
| <static> |
UserAction.isb(value)
判断是否为布尔类型
|
| <static> |
UserAction.isEqualArray(array1, array1)
判断2个数组是否相等
|
| <static> |
UserAction.isf(value)
判断是否为function
|
| <static> |
UserAction.isn(value)
判断是否为数字
|
| <static> |
UserAction.iso(value)
判断是否为对象
|
| <static> |
UserAction.iss(value)
判断是否为字符串
|
| <static> |
UserAction.isSameStyle(elementA, elementB)
判断两个元素的所有样式是否相同
|
| <static> |
UserAction.keydown(target, options)
模拟键盘按下事件
|
| <static> |
UserAction.keypress(target, options)
模拟键盘按键事件,包括鼠标按下和弹起
|
| <static> |
UserAction.keyup(target, options)
模拟键盘弹起事件
|
| <static> |
UserAction.manualDeleteFillData(node)
清除不可见字符
|
| <static> |
UserAction.mousedown(target, options)
模拟鼠标左键按下
|
| <static> |
UserAction.mousemove(target, options)
模拟鼠标移动
|
| <static> |
UserAction.mouseout(target, options)
模拟鼠标移出某一个元素事件
|
| <static> |
UserAction.mouseover(target, options)
模拟鼠标移动经过某一个元素事件
|
| <static> |
UserAction.mouseup(target, options)
模拟鼠标左键在某一个元素上弹起
|
| <static> |
UserAction.simulateKeyEvent(type, bubbles, cancelable, view, ctrlKey, altKey, shiftKey, metaKey, keyCode, charCode)
根据给定的事件信息模拟键盘事件,并冒泡到产生这个事件的对象上
|
| <static> |
UserAction.simulateMouseEvent(target, type, bubbles, cancelable, view, detail, screenX, screenY, clientX, clientY, ctrlKey, altKey, shiftKey, metaKey, button, relatedTarget)
模拟鼠标事件
|
Method Detail
<static>
{Boolean}
UserAction.checkAllChildAttribs(nodeA, nodeB)
检查两个节点(包含所有子节点)是否具有相同的属性
- Parameters:
- nodeA
- 比较的第一个节点
- nodeB
- 比较的另一个节点
- Returns:
- {Boolean} true或false
<static>
UserAction.checkHTMLSameStyle(html, doc, ele, descript)
查看传入的html是否与传入的元素ele具有相同的style,比较结束会执行QUnit的断言
- Parameters:
- {String} html
- 被比较的html字符串
- {HTMLElement} doc
- 当前的document对象
- {HTMLElement} ele
- 要被比较的元素,html与ele的innerHTML比较
- descript
<static>
UserAction.click(单击的元素对象, 单击事件的可选参数)
模拟鼠标单击事件
- Parameters:
- {HTMLElement} 单击的元素对象
- {Object} 单击事件的可选参数
<static>
UserAction.cssStyleToDomStyle(cssName)
统一cssFloat和styleFloat
- Parameters:
- cssName
<static>
UserAction.dblclick(双击的元素对象, 双击事件的可选参数)
模拟鼠标双击事件
- Parameters:
- {HTMLElement} 双击的元素对象
- {Object} 双击事件的可选参数
<static>
UserAction.delayhelper(oncheck, onsuccess,oncheck返回true时执行, onfail, timeout)
在一段时间内不断查询oncheck是否返回true,如果是则执行onsuccess,否则超时结束后执行onfail
- Parameters:
- {Function} oncheck
- 回调函数,定期检查某一个结果是否正确,如果是则返回true
- {Function} onsuccess,oncheck返回true时执行
- {Function} onfail
- 超时结束时执行,用例失败
- timeout
- {Number} 超时时间
<static>
{Array}
UserAction.findPosition(oElement)
找到给定元素的左上角和右下角顶点的横坐标和纵坐标
- Parameters:
- {HTMLElement} oElement
- Returns:
- {Array} [startX,startY,endX,endY]
<static>
UserAction.fireKeyEvent(type, 目标元素, options)
触发键盘事件,需要设置keyCode或charCode
- Parameters:
- {String} type
- 键盘事件类型 ("keyup", "keydown" or "keypress").
- {HTMLElement} 目标元素
- {Object} options
- 触发事件的参数,设置keyCode或charCode
<static>
UserAction.fireMouseEvent(target, type, options)
在某一个元素上模拟鼠标事件
- Parameters:
- {HTMLElement} target
- 被触发鼠标事件的元素
- {String} type
- 事件类型,如: click, dblclick, mousedown, mouseup, mouseout,mouseover, 和 mousemove.
- {Object} options
- 额外参数,使用DOM标准名称
<static>
UserAction.frameExt()
提供iframe扩展支持,用例测试需要独立场景的用例,由于异步支持,通过finish方法触发start
事件绑定在frame上,包括afterfinish和jsloaded
- Parameters:
- op.win
- window对象
- op.nojs
- 不加载额外js
- op.ontest
- 测试步骤
- op.onbeforestart
- {Function} 测试启动前处理步骤,默认为QUnit.stop();
- op.onafterfinish
- {Function} 测试完毕执行步骤,默认为QUnit.start()
<static>
UserAction.functionListHelper()
提供队列方式执行用例的方案,接口包括start、add、next,方法全部执行完毕时会启动用例继续执行
<static>
UserAction.getChildHTML(co)
获取某一个元素的innerHTML,去掉了不可见字符
- Parameters:
- co
<static>
{String}
UserAction.getFloatStyle(ele)
获取元素的float属性,ie下用styleFloat获取,非ie用cssFloat
- Parameters:
- {HTMLElement} ele
- 要获取float属性的元素
- Returns:
- {String} ele的float属性
<static>
UserAction.getHTML(co)
获取某一个元素的outerHTML
- Parameters:
- co
<static>
{Number}
UserAction.getIndex(node)
获取某一个节点在父节点所有孩子中的顺序
- Parameters:
- node
- 需要获取顺序的节点
- Returns:
- {Number} 顺序号,从0开始计数
<static>
{String}
UserAction.getSelectedText()
得到选中区域的文本
- Returns:
- {String} 选中区域的文本
<static>
{Boolean}
UserAction.hasSameAttrs(nodeA, nodeB)
判断两个元素的所有属性是否都相同
- Parameters:
- nodeA
- 比较的第一个节点
- nodeB
- 比较的另一个节点
- Returns:
- {Boolean} true或false
<static>
{Boolean}
UserAction.haveSameAllChildAttribs(nodeA, nodeB)
判断两个节点(包括所有子孙节点)所有的属性及style是否都相同
- Parameters:
- nodeA
- 比较的第一个节点
- nodeB
- 比较的另一个节点
- Returns:
- {Boolean} true或false
<static>
{Boolean}
UserAction.isb(value)
判断是否为布尔类型
- Parameters:
- {Any} value
- 判断的对象
- Returns:
- {Boolean} 真或假
<static>
{Boolean}
UserAction.isEqualArray(array1, array1)
判断2个数组是否相等
- Parameters:
- {Array} array1
- {Array} array1
- Returns:
- {Boolean} 真或假
<static>
{Boolean}
UserAction.isf(value)
判断是否为function
- Parameters:
- {Any} value
- 判断的对象
- Returns:
- {Boolean} 真或假
<static>
{Boolean}
UserAction.isn(value)
判断是否为数字
- Parameters:
- {Any} value
- 判断的对象
- Returns:
- {Boolean} 真或假
<static>
{Boolean}
UserAction.iso(value)
判断是否为对象
- Parameters:
- {Any} value
- 判断的对象
- Returns:
- {Boolean} 真或假
<static>
{Boolean}
UserAction.iss(value)
判断是否为字符串
- Parameters:
- {Any} value
- 判断的对象
- Returns:
- {Boolean} 真或假
<static>
{Boolean}
UserAction.isSameStyle(elementA, elementB)
判断两个元素的所有样式是否相同
- Parameters:
- elementA
- 比较的一个元素
- elementB
- 比较的另一个元素
- Returns:
- {Boolean} true或false
<static>
UserAction.keydown(target, options)
模拟键盘按下事件
- Parameters:
- {HTMLElement} target
- 鼠标事件的对象
- {Object} options
- 额外参数,使用DOM标准名称
<static>
UserAction.keypress(target, options)
模拟键盘按键事件,包括鼠标按下和弹起
- Parameters:
- {HTMLElement} target
- 鼠标事件的对象
- {Object} options
- 额外参数,使用DOM标准名称
<static>
UserAction.keyup(target, options)
模拟键盘弹起事件
- Parameters:
- {HTMLElement} target
- 鼠标事件的对象
- {Object} options
- 额外参数,使用DOM标准名称
<static>
UserAction.manualDeleteFillData(node)
清除不可见字符
- Parameters:
- node
- 需要清除不可见文本子节点的节点
<static>
UserAction.mousedown(target, options)
模拟鼠标左键按下
- Parameters:
- {HTMLElement} target
- 鼠标单击的对象
- {Object} options
- 额外参数,使用DOM标准名称
<static>
UserAction.mousemove(target, options)
模拟鼠标移动
- Parameters:
- {HTMLElement} target
- 鼠标事件的对象
- {Object} options
- 额外参数,使用DOM标准名称
<static>
UserAction.mouseout(target, options)
模拟鼠标移出某一个元素事件
- Parameters:
- {HTMLElement} target
- 鼠标事件的对象
- {Object} options
- 额外参数,使用DOM标准名称
<static>
UserAction.mouseover(target, options)
模拟鼠标移动经过某一个元素事件
- Parameters:
- {HTMLElement} target
- 鼠标事件的对象
- {Object} options
- 额外参数,使用DOM标准名称
<static>
UserAction.mouseup(target, options)
模拟鼠标左键在某一个元素上弹起
- Parameters:
- {HTMLElement} target
- 鼠标事件的对象
- {Object} options
- 额外参数,使用DOM标准名称
<static>
UserAction.simulateKeyEvent(type, bubbles, cancelable, view, ctrlKey, altKey, shiftKey, metaKey, keyCode, charCode)
根据给定的事件信息模拟键盘事件,并冒泡到产生这个事件的对象上
- Parameters:
- {HTMLElement} 被触发事件的元素.
- {String} type
- 事件类型,如: keyup, keydown, 或 keypress.
- {Boolean} bubbles
- (Optional) 事件是否允许冒泡,默认为true
- {Boolean} cancelable
- (Optional) 事件是否允许通过preventDefault取消,默认是true.
- {Window} view
- (Optional) 触发事件的window容器,默认就是window
- {Boolean} ctrlKey
- (Optional) 触发事件时是否触发ctrl键的事件,默认为false.
- {Boolean} altKey
- (Optional) I触发事件时是否触发atl键的事件,默认为false
- {Boolean} shiftKey
- (Optional) 触发事件时是否触发shift键的事件,默认为false.
- {Boolean} metaKey
- (Optional) 触发事件时是否触发meta键的事件,默认为false.
- {int} keyCode
- (Optional) 触发键盘事件时按下的键值(keycode),默认为0.
- {int} charCode
- (Optional) 触发键盘事件时按下的Unicode值(charCode),默认为0.
<static>
UserAction.simulateMouseEvent(target, type, bubbles, cancelable, view, detail, screenX, screenY, clientX, clientY, ctrlKey, altKey, shiftKey, metaKey, button, relatedTarget)
模拟鼠标事件
- Parameters:
- {HTMLElement} target
- 被触发事件的元素.
- {String} type
- 事件类型,如 click, dblclick, mousedown, mouseup, mouseout, mouseover, 和 mousemove
- {Boolean} bubbles
- (Optional) 事件是否允许冒泡,默认为true
- {Boolean} cancelable
- (Optional) 事件是否允许通过preventDefault取消,默认是true.
- {Window} view
- (Optional) 触发事件的window容器,默认就是window
- {int} detail
- (Optional) 鼠标按钮使用的次数,默认是1
- {int} screenX
- (Optional) 事件触发时相对屏幕上的x坐标,默认是0
- {int} screenY
- (Optional) 事件触发时相对屏幕上的Y坐标,默认是0
- {int} clientX
- (Optional) 事件触发时相对client上的X坐标,默认是0
- {int} clientY
- (Optional) 事件触发时相对client上的Y坐标,默认是0
- {Boolean} ctrlKey
- (Optional) 触发事件时是否触发ctrl键的事件,默认为false.
- {Boolean} altKey
- (Optional) I触发事件时是否触发atl键的事件,默认为false
- {Boolean} shiftKey
- (Optional) 触发事件时是否触发shift键的事件,默认为false.
- {Boolean} metaKey
- (Optional) 触发事件时是否触发meta键的事件,默认为false.
- {int} button
- (Optional) 鼠标按下的键,0指左键,1中间键,2指右键,默认是0.
- {HTMLElement} relatedTarget
- (Optional) 事件相关的目标元素,mouseout事件中指鼠标移动到的元素,mouseover指鼠标从哪一个元素移动过来,其他事件忽略这个参数,默认是null